home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / sccs.z / sccs
Text File  |  1998-10-20  |  8KB  |  199 lines
  1.  
  2.  
  3.  
  4. SSSSCCCCCCCCSSSS((((1111))))                                                                SSSSCCCCCCCCSSSS((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      sccs - front end for the SCCS subsystem
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ssssccccccccssss [ ----rrrr ] [ ----dddd_p_a_t_h ] [ ----pppp_p_a_t_h ] command [ flags ] [ args ]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _S_c_c_s is a front end to the SCCS programs that helps them mesh more
  16.      cleanly with the rest of UNIX.  It also includes the capability to run
  17.      ``set user id'' to another user to provide additional protection.
  18.  
  19.      Basically, _s_c_c_s runs the _c_o_m_m_a_n_d with the specified _f_l_a_g_s and _a_r_g_s. Each
  20.      argument is normally modified to be prepended with ``SCCS/s.''.
  21.  
  22.      Flags to be interpreted by the _s_c_c_s program must be before the _c_o_m_m_a_n_d
  23.      argument.  Flags to be passed to the actual SCCS program must come after
  24.      the _c_o_m_m_a_n_d argument.  These flags are specific to the command and are
  25.      discussed in the documentation for that command.
  26.  
  27.      Besides the usual SCCS commands, several ``pseudo-commands'' can be
  28.      issued.  These are:
  29.  
  30.      edit      Equivalent to ``get -e''.
  31.  
  32.      delget    Perform a delta on the named files and then get new versions.
  33.                The new versions will have id keywords expanded, and will not
  34.                be editable.  The -m, -p, -r, -s, and -y flags will be passed
  35.                to delta, and the -b, -c, -e, -i, -k, -l, -s, and -x flags will
  36.                be passed to get.
  37.  
  38.      deledit   Equivalent to ``delget'' except that the ``get'' phase includes
  39.                the ``-e'' flag.  This option is useful for making a
  40.                ``checkpoint'' of your current editing phase.  The same flags
  41.                will be passed to delta as described above, and all the flags
  42.                listed for ``get'' above except -e and -k are passed to
  43.                ``edit''.
  44.  
  45.      create    Creates an SCCS file, taking the initial contents from the file
  46.                of the same name.  Any flags to ``admin'' are accepted.  If the
  47.                creation is successful, the files are renamed with a comma on
  48.                the front.  These should be removed when you are convinced that
  49.                the SCCS files have been created successfully.
  50.  
  51.      fix       Must be followed by a ----rrrr flag.  This command essentially
  52.                removes the named delta, but leaves you with a copy of the
  53.                delta with the changes that were in it.  It is useful for
  54.                fixing small compiler bugs, etc.  Since it doesn't leave audit
  55.                trails, it should be used carefully.
  56.  
  57.      clean     This routine removes everything from the current directory that
  58.                can be recreated from SCCS files.  It will not remove any files
  59.                being edited.  If the ----bbbb flag is given, branches are ignored in
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSCCCCCCCCSSSS((((1111))))                                                                SSSSCCCCCCCCSSSS((((1111))))
  71.  
  72.  
  73.  
  74.                the determination of whether they are being edited; this is
  75.                dangerous if you are keeping the branches in the same
  76.                directory.
  77.  
  78.      unedit    This is the opposite of an ``edit'' or a ``get -e''.  It should
  79.                be used with extreme caution, since any changes you made since
  80.                the get will be irretrievably lost.
  81.  
  82.      info      Gives a listing of all files being edited.  If the ----bbbb flag is
  83.                given, branches (i.e., SID's with two or fewer components) are
  84.                ignored.  If the ----uuuu flag is given (with an optional argument)
  85.                then only files being edited by you (or the named user) are
  86.                listed.
  87.  
  88.      check     Like ``info'' except that nothing is printed if nothing is
  89.                being edited, and a non-zero exit status is returned if
  90.                anything is being edited.  The intent is to have this included
  91.                in an ``install'' entry in a makefile to insure that everything
  92.                is included into the SCCS file before a version is installed.
  93.  
  94.      tell      Gives a newline-separated list of the files being edited on the
  95.                standard output.  Takes the ----bbbb and ----uuuu flags like ``info'' and
  96.                ``check''.
  97.  
  98.      diffs     Gives a ``diff'' listing between the current version of the
  99.                program(s) you have out for editing and the versions in SCCS
  100.                format.  The ----rrrr,,,, ----cccc,,,, ----iiii,,,, ----xxxx,,,, and ----tttt flags are passed to _g_e_t;
  101.                the ----llll,,,, ----ssss,,,, ----eeee,,,, ----ffff,,,, ----hhhh,,,, and ----bbbb options are passed to _d_i_f_f. The
  102.                ----CCCC flag is passed to _d_i_f_f as ----cccc....
  103.  
  104.      print     Prints out verbose information about the named files.  ----cccc....
  105.  
  106.      prs       Prints out the delta information about the named files.  All
  107.                the _p_r_s(1) can be specified.
  108.  
  109.      The ----rrrr flag runs _s_c_c_s as the real user rather than as whatever effective
  110.      user _s_c_c_s is ``set user id'' to.  The ----dddd flag gives a root directory for
  111.      the SCCS files.  The default is the current directory.  The ----pppp flag
  112.      defines the pathname of the directory in which the SCCS files will be
  113.      found; ``SCCS'' is the default.  The ----pppp flag differs from the ----dddd flag in
  114.      that the ----dddd argument is prepended to the entire pathname and the ----pppp
  115.      argument is inserted before the final component of the pathname.  For
  116.      example, ``sccs -d/x -py get a/b'' will convert to ``get /x/a/y/s.b''.
  117.      The intent here is to create aliases such as ``alias syssccs sccs
  118.      -d/usr/src'' which will be used as ``syssccs get cmd/who.c''.  Also, if
  119.      the environment variable PROJECTDIR is set, its value is used to
  120.      determine the ----dddd ffffllllaaaagggg.... If it begins with a slash, it is taken directly;
  121.      otherwise, the home directory of a user of that name is examined for a
  122.      subdirectory ``src'' or ``source''.  If such a directory is found, it is
  123.      used.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. SSSSCCCCCCCCSSSS((((1111))))                                                                SSSSCCCCCCCCSSSS((((1111))))
  137.  
  138.  
  139.  
  140.      Certain commands (such as _a_d_m_i_n) cannot be run ``set user id'' by all
  141.      users, since this would allow anyone to change the authorizations.  These
  142.      commands are always run as the real user.
  143.  
  144. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  145.      To get a file for editing, edit it, and produce a new delta:
  146.  
  147.           sccs get -e file.c
  148.           ex file.c
  149.           sccs delta file.c
  150.  
  151.      To get a file from another directory:
  152.  
  153.           sccs -p/usr/src/sccs/s. get cc.c
  154.  
  155.      or
  156.  
  157.           sccs get /usr/src/sccs/s.cc.c
  158.  
  159.      To make a delta of a large number of files in the current directory:
  160.  
  161.           sccs delta *.c
  162.  
  163.      To get a list of files being edited that are not on branches:
  164.  
  165.           sccs info -b
  166.  
  167.      To delta everything being edited by you:
  168.  
  169.           sccs delta `sccs tell -u`
  170.  
  171.      In a makefile, to get source files from an SCCS file if it does not
  172.      already exist:
  173.  
  174.           SRCS = <list of source files>
  175.           $(SRCS):
  176.                sccs get $(REL) $@
  177.  
  178. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  179.      admin(1), comb(1), delta(1), get(1), help(1), prs(1), rmdel(1),
  180.      sccsdiff(1), what(1)
  181.  
  182. BBBBUUUUGGGGSSSS
  183.      It should be able to take directory arguments on pseudo-commands like the
  184.      SCCS commands do.
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.